home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / manageme / snmp-dev.000 / snmp-dev / README < prev    next >
Encoding:
Text File  |  1995-07-19  |  4.7 KB  |  115 lines
  1.  
  2.     This is an ELF binary release of CMU's snmp version 2.1.2l3 intended
  3. primarily for those wishing to develop SNMP-using software. Just verify the
  4. makefile and then use it to install all files in their proper places
  5.  
  6.     All of the included files are Copyright (C) 1988-1992 Carnegie
  7. Mellon University. Any errors or mistakes in this release are probably my
  8. fault. E-Mail me at Stimpson@Panix.COM.
  9.  
  10.     Example source is in the "examples" subdirectory.
  11.  
  12.     The information below is from the README.linux file included with
  13. the Linux source release and is written by those who ported the CMU package
  14. to Linux, Juergen Schoenwaelder (schoenw@ibr.cs.tu-bs.de) and Erik
  15. Schoenfelder (schoenfr@ibr.cs.tu-bs.de).
  16.  
  17. ----------------------------------------------------------------------------
  18.  
  19. The original cmu code (cmu-snmp2.1.2.tar.Z) is hopefully avail at your
  20. nearest, well assorted ftp-server.
  21.  
  22. The source changes belongs mostly to the agent/*.[ch] files for the snmpd
  23. agent and snmplib/snmp.c for the snmpd.conf reading.  The linux version of
  24. snmpd uses mainly the /proc/* files, /etc/mtab and some ioctl's for the
  25. interface parameters.
  26.  
  27. Setting the writeable system group variables now works (the values are
  28. saved in the snmpd.conf file) and the `private' community string for
  29. V1 is now configurable via the config file (other communities than
  30. `public' and the private community string are now disabled). The
  31. host-mib (RFC 1514) is partially added. To be on the secure side,
  32. hostSWRun{Perf} requests are only answered for V1 ``private''requests,
  33. and the configured V2 views.
  34.  
  35. Files installed for the applications:
  36.  
  37.     /usr/bin/snmpwalk        /usr/bin/snmptest
  38.     /usr/bin/snmptranslate        /usr/bin/snmpget
  39.     /usr/bin/snmptrapd        /usr/bin/snmpnetstat
  40.     /usr/bin/mib.txt
  41.     /etc/{snmpd,acl,context,party,view}.conf   (if not already installed)
  42.     /usr/man/man1/snmpwalk.1    /usr/man/man1/snmptest.1
  43.     /usr/man/man1/snmptranslate.1    /usr/man/man1/snmpset.1
  44.     /usr/man/man1/snmpget.1        /usr/man/man1/snmpnetstat.1
  45.     /usr/man/man5/variables.5    /usr/man/man8/snmptrapd.8
  46.  
  47.  
  48. STARTUP AT BOOTTIME:
  49.  
  50. To run ``snmpd'' at boottime add a line to /etc/rc.local containing:
  51.  
  52.     /usr/sbin/snmpd >/dev/null 2>&1 &
  53.  
  54. You may test it with ``snmpwalk -v 1 localhost public'' or choose
  55. tkined's SNMP Trouble-Shooter or SNMP-Browser to contact the agent.
  56.  
  57. Please have a look at the original README file too and for the
  58. copyright refer to agent/snmpd.c.
  59.  
  60. If you are running a CD-based Linux-system (/usr/lib mounted readonly
  61. from CD), you may copy mib.txt to /etc and it will be used instead.
  62.  
  63.  
  64.  
  65. NEWS:
  66.     * cmu-snmp2.1.2l3 wrapped.
  67.     * ipNetToMediaType now should distinguish between static, dynamic 
  68.       and other arp entries, instead of telling always dynamic.
  69.         * V2 communication with MD5 authentication seems to work fine.
  70.     * man/{snmpset.1,snmpget.1,snmpnetstat.1,snmptrapd.8} and
  71.       apps/snmpset.c added from cmu-snmp2.1.2.1.tar.gz, which was
  72.       created/modified by dpz@noc.rutgers.edu, 15 July 1994 for 
  73.       SunOS 5.x.
  74.     * snmpnetstat failed due to a uninitialized variable, when 
  75.       running the optimized version; fixed.
  76.     * at least gcc v2.6.2 miscompiles snmplib/snmp_acl.c with
  77.       optimisation switched on; harmless workaround added.
  78.     * hrSWRun[Perf] restricted to V1 ``private'' requests.
  79.     * from the host resources mib (rfc1514) the hrSystem group 
  80.       and parts of hrStorage, hrDevice, hrSWRun and hrSWRunPerf 
  81.       are added.
  82.     * sysName, sysContact, sysLocation are now setable,
  83.       and remembered in /etc/snmpd.conf (if present); the real
  84.       hostname is not changed.
  85.     * system.sysUpTime now returns the ticks up the uptime of the
  86.       agent, not the system (host.hrSystem.hrSystemUptime tells this).
  87.     * Interface_Scan_By_Index() in agent/snmp_vars.c tries to
  88.       optimize identical consecutive requests; timeout added,
  89.       because identical answers after long intervals are simplely
  90.       wrong.
  91.     * cmu-snmp2.1.2l2 wrapped.
  92.     * MIB-II snmp group added (nearly complete).
  93.     * ipNetToMedia added; udpEntry added.
  94.     * ifSpecific added; ipRouteMask added (ipRouteInfo prepared).
  95.     * /etc/snmpd.conf added - this means setable Location and Contact.
  96.     * cmu-snmp2.1.2l1 wrapped.
  97.  
  98. BUGS and TODO:
  99.     * snmpwalk into the party mib shows objectid's with reversed
  100.       ip-adresses.
  101.     * add nfs-mounted volumes to hrFSRemoteMountPoint.
  102.     * setting of routing entries run in an encoding error. haven't 
  103.       tracked this down yet; the code is a mess... patches are
  104.       welcome.
  105.     * speedup: the complete reading of the ifnet is very expensive.
  106.     * byte-order: the code was written for network-byte-order;
  107.        i guess there are some missing conversions in the applications.
  108.     * still for harware-adresses only ethernet is assumed.
  109.         * manpages/docs: aeh, umm - beam me up.
  110.  
  111. Have fun.
  112.  
  113. Juergen Schoenwaelder (schoenw@ibr.cs.tu-bs.de)
  114. Erik Schoenfelder (schoenfr@ibr.cs.tu-bs.de)
  115.